 Prev |
Print
Upgrading to v1.4 requires a system with minimally v1.3 installed. For the instructions on how to upgrade to v1.3 refer to Upgrading to Adaptive Print Studio v1.3.
Upgrading from 1.3 to 1.4
Use these instructions to upgrade the Adaptive Print Studio module from version 1.3 to version 1.4:
Important for installing the Sitecore package(s).
General:
- All items in core database, the templates, and branches in the master database will be merged (installation options merge/merge). This means that the versions of existing APS items will be overwritten. (If any custom access rights/ template field values have been changed, they will be overwritten).
- Adaptive Print Studio 1.4 package, (Core) Server components for InDesign, InCopy and InDesign Server.
Therefore, the configuration files are split into PrintStudio.config for the Core package, and PrintStudio.Silverlight.config for the Silverlight package. When you upgrade, the configuration files are not overwritten. Therefore it is recommended to backup/rename the PrintStudio.config file from the previous version in order to get the new clean PrintStudio.config file.
New Transformation items:
- All items -Definitions and Default TransformationSet- are new Sitecore items. Therefore we recommend not using items from the previous version. When you need to keep customized settings from the previous version, you can choose to move the items to an obsolete folder. After upgrading, the required references can be reviewed and replaced.
- After installing the Core package the new Default TransformationSet must be selected in Default Transformation field in /sitecore/Print Studio/Modules/InDesign connector/Other Settings/Default settings/Default settings.
Configuration settings for HtmlAgilityPack Sitecore 7.0 (and higher):
When using the transformations for the Rich Text field type the content item fields used for dynamic text from the Content panel (InDesign Connector) might be shown empty and the log will show an error message as below.
“Could not load file or assembly 'HtmlAgilityPack, Version=1.4.0.0, Culture=neutral, PublicKeyToken=bd319b19eaf3b43a' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)”
This can be solved by adding the following “runtime” section to the Sitecore web.config file after the tag:
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly><assemblyIdentity name="HtmlAgilityPack" publicKeyToken="bd319b19eaf3b43a" culture="neutral" /><bindingRedirect oldVersion="1.4.0.0" newVersion="1.4.6.0" />
</dependentAssembly>
</assemblyBinding>
</runtime>
Save the changes and restart the website.
Configuration settings for disallowing Sitecore 7.5 Media Protection:
For Sitecore 7.5 installations, you need to disallow media protection for the Adaptive Print Studio services in order to have access to Sitecore media files. You can do this by adding the following section to the end of the PrintStudio.config file, before </sitecore>:
<site x:before="*[@name='website']" name="printstudio" virtualFolder="/printstudio/services" physicalFolder="/printstudio/services/" rootPath="/sitecore/content" language="en" database="master" domain="sitecore" enableWorkflow="true" enableAnalytics="false" />
</sites>
<mediaLibrary>
<requestProtection><ignoreSites><site name="printstudio"/></ignoreSites></requestProtection>
</mediaLibrary>
Upgrading
Server side:
- Back up the site.
- Review the corresponding installation manual.
- Download the required packages.
- Follow the steps as described in the installation manual.
Client Side:
- Review the installation instructions for the corresponding version on the download page.
Prev